home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zsymv.z / zsymv
Text File  |  1996-03-14  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZSSSSYYYYMMMMVVVV((((3333FFFF))))                                                            ZZZZSSSSYYYYMMMMVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZSYMV - perform the matrix-vector operation   y := alpha*A*x + beta*y,
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE ZSYMV( UPLO, N, ALPHA, A, LDA, X, INCX, BETA, Y, INCY )
  13.  
  14.          CHARACTER     UPLO
  15.  
  16.          INTEGER       INCX, INCY, LDA, N
  17.  
  18.          COMPLEX*16    ALPHA, BETA
  19.  
  20.          COMPLEX*16    A( LDA, * ), X( * ), Y( * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      ZSYMV  performs the matrix-vector  operation
  24.  
  25.      where alpha and beta are scalars, x and y are n element vectors and A is
  26.      an n by n symmetric matrix.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      UPLO   - CHARACTER*1
  31.             On entry, UPLO specifies whether the upper or lower triangular
  32.             part of the array A is to be referenced as follows:
  33.  
  34.             UPLO = 'U' or 'u'   Only the upper triangular part of A is to be
  35.             referenced.
  36.  
  37.             UPLO = 'L' or 'l'   Only the lower triangular part of A is to be
  38.             referenced.
  39.  
  40.             Unchanged on exit.
  41.  
  42.      N      - INTEGER
  43.             On entry, N specifies the order of the matrix A.  N must be at
  44.             least zero.  Unchanged on exit.
  45.  
  46.      ALPHA  - COMPLEX*16
  47.             On entry, ALPHA specifies the scalar alpha.  Unchanged on exit.
  48.  
  49.      A      - COMPLEX*16 array, dimension ( LDA, N )
  50.             Before entry, with  UPLO = 'U' or 'u', the leading n by n upper
  51.             triangular part of the array A must contain the upper triangular
  52.             part of the symmetric matrix and the strictly lower triangular
  53.             part of A is not referenced.  Before entry, with UPLO = 'L' or
  54.             'l', the leading n by n lower triangular part of the array A must
  55.             contain the lower triangular part of the symmetric matrix and the
  56.             strictly upper triangular part of A is not referenced.  Unchanged
  57.             on exit.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZSSSSYYYYMMMMVVVV((((3333FFFF))))                                                            ZZZZSSSSYYYYMMMMVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LDA    - INTEGER
  75.             On entry, LDA specifies the first dimension of A as declared in
  76.             the calling (sub) program. LDA must be at least max( 1, N ).
  77.             Unchanged on exit.
  78.  
  79.      X      - COMPLEX*16 array, dimension at least
  80.             ( 1 + ( N - 1 )*abs( INCX ) ).  Before entry, the incremented
  81.             array X must contain the N- element vector x.  Unchanged on exit.
  82.  
  83.      INCX   - INTEGER
  84.             On entry, INCX specifies the increment for the elements of X. INCX
  85.             must not be zero.  Unchanged on exit.
  86.  
  87.      BETA   - COMPLEX*16
  88.             On entry, BETA specifies the scalar beta. When BETA is supplied as
  89.             zero then Y need not be set on input.  Unchanged on exit.
  90.  
  91.      Y      - COMPLEX*16 array, dimension at least
  92.             ( 1 + ( N - 1 )*abs( INCY ) ).  Before entry, the incremented
  93.             array Y must contain the n element vector y. On exit, Y is
  94.             overwritten by the updated vector y.
  95.  
  96.      INCY   - INTEGER
  97.             On entry, INCY specifies the increment for the elements of Y. INCY
  98.             must not be zero.  Unchanged on exit.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.